

<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
  <meta charset="utf-8">
  
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  
  <title>3.1.7.1.2. eleLoad Command &mdash; OpenSees Documentation  documentation</title>
  

  
  
  
  

  
  <script type="text/javascript" src="../../../_static/js/modernizr.min.js"></script>
  
    
      <script type="text/javascript" id="documentation_options" data-url_root="../../../" src="../../../_static/documentation_options.js"></script>
        <script type="text/javascript" src="../../../_static/jquery.js"></script>
        <script type="text/javascript" src="../../../_static/underscore.js"></script>
        <script type="text/javascript" src="../../../_static/doctools.js"></script>
        <script type="text/javascript" src="../../../_static/language_data.js"></script>
        <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
    
    <script type="text/javascript" src="../../../_static/js/theme.js"></script>

    

  
  <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
  <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
  <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
    <link rel="index" title="Index" href="../../../genindex.html" />
    <link rel="search" title="Search" href="../../../search.html" />
    <link rel="next" title="3.1.7.1.3. sp Command" href="sp.html" />
    <link rel="prev" title="3.1.7.1.1. load Command" href="load.html" /> 
</head>

<body class="wy-body-for-nav">

   
  <div class="wy-grid-for-nav">
    
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search" >
          

          
            <a href="../../../index.html">
          

          
            
            <img src="../../../_static/OpenSeesLogo.png" class="logo" alt="Logo"/>
          
          </a>

          
            
            
          

          
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>

          
        </div>

        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
          
            
            
              
            
            
              <p class="caption"><span class="caption-text">Applications for Users</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../interpreters.html">1. OpenSees Interpreters</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../install.html">2. Installation</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../../userManual.html">3. Command Manual</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="../modelCommands.html">3.1. Modelling Commands</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="model.html">3.1.1. Model Command</a></li>
<li class="toctree-l3"><a class="reference internal" href="node.html">3.1.2. Node Command</a></li>
<li class="toctree-l3"><a class="reference internal" href="element.html">3.1.3. Element Command</a></li>
<li class="toctree-l3"><a class="reference internal" href="spConstraints.html">3.1.4. SP_Constraint Commands</a></li>
<li class="toctree-l3"><a class="reference internal" href="mpConstraints.html">3.1.5. MP_Constraint Commands</a></li>
<li class="toctree-l3"><a class="reference internal" href="timeSeries.html">3.1.6. Time Series Command</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="pattern.html">3.1.7. Pattern Command</a><ul class="current">
<li class="toctree-l4 current"><a class="reference internal" href="plainPattern.html">3.1.7.1. Plain Pattern</a></li>
<li class="toctree-l4"><a class="reference internal" href="uniformExcitationPattern.html">3.1.7.2. Uniform Excitation</a></li>
<li class="toctree-l4"><a class="reference internal" href="multiSupportPattern.html">3.1.7.3. Multisupport Excitation</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../analysisCommands.html">3.2. Analysis Commands</a></li>
<li class="toctree-l2"><a class="reference internal" href="../outputCommands.html">3.3. Output Commands</a></li>
<li class="toctree-l2"><a class="reference internal" href="../materialCommands.html">3.4. Material Commands</a></li>
<li class="toctree-l2"><a class="reference internal" href="../miscCommands.html">3.5. Misc. Commands</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../userExamples.html">4. Examples</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../messageBoard.html">5. Questions, Bugs &amp; Feauture Requests</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/license.html">6. Copyright and License</a></li>
</ul>
<p class="caption"><span class="caption-text">Framework for Developer</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/sourceCode.html">1. Source Code</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/build.html">2. Building Application</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/references.html">3. References</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/extend.html">4. Extending Application</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/contribute.html">5. Contributing Code</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/issues.html">6. Issues</a></li>
</ul>

            
          
        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

      
      <nav class="wy-nav-top" aria-label="top navigation">
        
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="../../../index.html">OpenSees Documentation</a>
        
      </nav>


      <div class="wy-nav-content">
        
        <div class="rst-content">
        
          















<div role="navigation" aria-label="breadcrumbs navigation">

  <ul class="wy-breadcrumbs">
    
      <li><a href="../../../index.html">Docs</a> &raquo;</li>
        
          <li><a href="../../userManual.html"><span class="section-number">3. </span>Command Manual</a> &raquo;</li>
        
          <li><a href="../modelCommands.html"><span class="section-number">3.1. </span>Modelling Commands</a> &raquo;</li>
        
          <li><a href="pattern.html"><span class="section-number">3.1.7. </span>Pattern Command</a> &raquo;</li>
        
          <li><a href="plainPattern.html"><span class="section-number">3.1.7.1. </span>Plain Pattern</a> &raquo;</li>
        
      <li><span class="section-number">3.1.7.1.2. </span>eleLoad Command</li>
    
    
      <li class="wy-breadcrumbs-aside">
        
            
            <a href="../../../_sources/user/manual/model/eleLoad.rst.txt" rel="nofollow"> View page source</a>
          
        
      </li>
    
  </ul>

  
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
            
  <div class="section" id="eleload-command">
<span id="eleload"></span><h1><span class="section-number">3.1.7.1.2. </span>eleLoad Command<a class="headerlink" href="#eleload-command" title="Permalink to this headline">¶</a></h1>
<p>The eleLoad command is used to construct an ElementalLoad object and add it to the enclosing LoadPattern.</p>
<dl class="function">
<dt>
<code class="sig-name descname">eleLoad $eleLoad $arg1 $arg2 $arg3 ....</code></dt>
<dd></dd></dl>

<p>The beam column elements all accept eleLoad commands of the following form:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>eleLoad -ele $eleTag1 &lt;$eleTag2 ....&gt; -type -beamUniform $Wy &lt;$Wx&gt;
</pre></div>
</div>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>eleLoad -range $eleTag1 $eleTag2 -type -beamPoint $Py $xL &lt;$Px&gt;
</pre></div>
</div>
<p>When NDM=3, the beam column elements all accept eleLoad commands of the following form:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>eleLoad -ele $eleTag1 &lt;$eleTag2 ....&gt; -type -beamUniform $Wy $Wz &lt;$Wx&gt;
</pre></div>
</div>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>eleLoad -range $eleTag1 $eleTag2 -type -beamPoint $Py $Pz $xL &lt;$Px&gt;
</pre></div>
</div>
<table class="colwidths-given docutils align-default">
<colgroup>
<col style="width: 17%" />
<col style="width: 17%" />
<col style="width: 67%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Argument</p></th>
<th class="head"><p>Type</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>$eleTags</p></td>
<td><p><em>list integer</em></p></td>
<td><p>tags of PREVIOUSLY DEFINED element</p></td>
</tr>
<tr class="row-odd"><td><p>$Wx</p></td>
<td><p><em>float</em></p></td>
<td><p>mag of uniformily distributed ref load acting in direction along member length</p></td>
</tr>
<tr class="row-even"><td><p>$Wy</p></td>
<td><p><em>float</em></p></td>
<td><p>mag of uniformily distributed ref load acting in local y direction of element</p></td>
</tr>
<tr class="row-odd"><td><p>$Wz</p></td>
<td><p><em>float</em></p></td>
<td><p>mag of uniformily distributed ref load acting in local z direction of element</p></td>
</tr>
<tr class="row-even"><td><p>$Py</p></td>
<td><p><em>float</em></p></td>
<td><p>mag of ref point load acting in direction along member length</p></td>
</tr>
<tr class="row-odd"><td><p>$Py</p></td>
<td><p><em>float</em></p></td>
<td><p>mag of ref point load acting in local y direction of element</p></td>
</tr>
<tr class="row-even"><td><p>$Pz</p></td>
<td><p><em>float</em></p></td>
<td><p>mag of ref point load acting in local z direction of element</p></td>
</tr>
<tr class="row-odd"><td><p>$xL   location of point load relative to node I</p></td>
<td><p>prescribed as fraction of element length</p></td>
<td></td>
</tr>
</tbody>
</table>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>The load values are reference loads values, it is the time sereries that provides the load factor. The load factor times the reference values is the load that is actually applied to the node.</p>
</div>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>At the moment, eleLoads do not work with 3D beam-column elements if Corotational geometric transformation is used.</p>
</div>
<div class="highlight-tcl notranslate"><div class="highlight"><pre><span></span><span class="k">set</span> width <span class="mf">20.0</span>
<span class="k">set</span> W <span class="mf">4000.0</span><span class="k">;</span>
<span class="nv">timeSeries</span> Linear <span class="mi">1</span>
<span class="nv">pattern</span> Plain <span class="mi">1</span> <span class="mi">1</span> <span class="k">{</span>
    <span class="nv">eleLoad</span> <span class="o">-</span>ele <span class="mi">3</span> <span class="o">-</span>type <span class="o">-</span>beamUniform <span class="k">[expr</span> <span class="o">-</span><span class="nv">$W</span><span class="o">/</span><span class="nv">$width</span><span class="k">]</span>
<span class="k">}</span>
</pre></div>
</div>
<div class="highlight-tcl notranslate"><div class="highlight"><pre><span></span>width = 20.0;
W = 4000.0;
timeSeries(&#39;Linear&#39;, 1)
pattern(&#39;Plain&#39;,1,1)
eleLoad(&#39;-ele&#39;,3, &#39;-type&#39;, -beamUniform&#39;, W/width)
</pre></div>
</div>
<p>Code Developed by: <strong>fmk</strong></p>
</div>


           </div>
           
          </div>
          <footer>
  

  <hr/>

  <div role="contentinfo">
    <p>
        &copy; Copyright 2020, The Regents of the University of California

    </p>
  </div>
  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 

</footer>

        </div>
      </div>

    </section>

  </div>
  


  <script type="text/javascript">
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script>

  
  
    
    <!-- Theme Analytics -->
    <script>
    (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
      (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
      m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
    })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');

    ga('create', 'UA-2431545-1', 'auto');
    ga('send', 'pageview');
    </script>

    
    

  <style>
         .wy-nav-content { max-width: none; }
  </style>



</body>
</html>